package com.nageoffer.shortlink.admin.service;

import com.baomidou.mybatisplus.extension.service.IService;
import com.nageoffer.shortlink.admin.dao.entity.UserDO;
import com.nageoffer.shortlink.admin.dto.req.UserLoginReqDTO;
import com.nageoffer.shortlink.admin.dto.req.UserRegisterReqDTO;
import com.nageoffer.shortlink.admin.dto.req.UserUpdateReqDTO;
import com.nageoffer.shortlink.admin.dto.resp.UserLoginRespDTO;
import com.nageoffer.shortlink.admin.dto.resp.UserRespDTO;
import org.springframework.stereotype.Service;

/**
 * @author zhaoyf
 * @version 1.0
 * @description 用户接口层
 * @date 2024/11/23 17:06
 */
@Service
public interface UserService extends IService<UserDO> {

    /**
     * 根据用户名获取用户信息
     *
     * @param username 用户姓名
     * @return  用户信息
     */
    UserRespDTO getUserByUsername(String username);

    /**
     * 判断用户名是否存在
     * @param username 用户名
     * @return true:存在 false:不存在
     */
    Boolean hasUsername(String username);


    /**
     * 用户注册
     * @param requestParam 用户注册信息
     */
    void register(UserRegisterReqDTO requestParam);

    /**
     * 修改用户信息
     * @param requestParam 用户信息
     */
    void update(UserUpdateReqDTO requestParam);

    /**
     * 用户登陆
     * @param requestParam 用户登陆信息
     * @return  用户登录成功信息
     */
    UserLoginRespDTO login(UserLoginReqDTO requestParam);

    /**
     * 检查用户是否登录
     * @param username 用户姓名
     * @param token 用户登录 token
     * @return true:已登录 false:未登录
     */
    Boolean checkLogin(String username, String token);

    /**
     * 退出登录
     * @param username 用户姓名
     * @param token 用户登录token
     */
    void logout(String username, String token);
}
